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ODT-I I (octal debugging tape) is an aid used in debugging a PDP-8 program by faci litating 
communication with the program being run . The communication between operator and program is via the 
ASR-33 Teletypewriter . 

ODT-I I features include register examination and modification, binary punchouts, control 
transfer, word search ing, octal dumping and instruction trapouts to ODT-I I contro I ( break-traps) . ODT-I I 
makes no use of the program interrupt facility and is restricted to one memory module. 

3. REQUIREMENTS 

3.1 Storage 

ODT-li requires 600 (octal) registers and resides in memory between 7000 and 7577 (or 1000 - 
1 577) . in addition, ODT-1 1 uses register 0005 . 

3.3 Equipment 

Standard PDP-8 . 

4. USAGE 



Loading 

ODT-ll is loaded by means of the Binary Loader (see Digital-8-2-U) . 

Place proper ODT-ll tape in reader (either high or low version). 

Set the SWITCH REGISTER to 7777 and press LOAD ADDRESS. 

if using the 750 Reader, put switch 0 down and press START. If using the 33-ASR Reader, 
put switch 0 up and press START. ' 

4.1.4 Read the binary tape of the program to be debugged into core as above. (Make sure that the 
program to be debugged does not overlap ODT-I I and vice versa) . 

4.4 Start-Up 

The starting address of ODT-ll is 7000 (1000 is low version). 

4-4. 1 Set ODT-ll starting address in the SWITCH REGISTER (1000 or 7000) . 

4.4,2 Press LOAD ADDRESS, and press START . ODT-ll is now running and is awaiting commands 

from the 33-ASR Keyboard . 



4.1 

4.1.1 

4.1.2 
4.1 .3 



5. RESTRICTIONS 



5.1 Status Active Registers 



Register 0005 (page 0) is used 
by ODT-I I with an address within ODT-I I . 
instruction at the location of the trap and 



by ODT-I I when executing a break -trap . This register is fi I led 
When the operator requests a break-trap, ODT-ll saves the 
replaces it with the instruction, JMP I 5, thus returning control 
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to ODT-II . ODT-II also uses 600 (octal) locations from 1000 - 1577 (low version) or 7000 - 7577 (high 
version). The programmer must be certain that his program to be debugged does not overlap ODT-II . 

5.2 Status Core 

ODT-II will not operate outside of the core memory modu le in which it resides . 

6. DESCRIPTION 

I octal debugging program for the PDP-8 . Operator communication occurs on the 

Teletype (33-ASR). A number is a string of digits taken as octal . Other characters are either control 
characters or are i I legal . 

• I ODT-II 's most useful features is the "break-trap". When debugging a program, it is 

o ten desirable to allow control to flow up to a certain point, at which time the programmer would like to 
examine the contents of the accumulator, the link, and various other registers of his program . To facil- 
itate this ODT-II will insert in the user's program a jump instruction into ODT-II, which will cause the 
C(AC) and C(L) to be preserved. ODT-II will then print out the break location and the contents of the 

possible to move the break-trap and continue the program, restoring 
the C(AC), C(L), and the trapped instruction. The trapped instruction is executed and control is returned 
to the user s program. 



6.1 
6.1 .1 

6.1 .1 .1 



Discussion 
Commands 
Slash (/) 



The register examination character / causes the contents of the register addressed by the pre- 
ceding expression to be typed out in octal. The register is then opened for modification and the location 
sequence reset to the address. 

Example: 

1/ 0027 

(In all examples, everything underlined is typed by ODT-II; everything not underlined is 
typed by the user.) 

6.1 .1 .2 Carriage Return (^ ) 

The value of any expression that has been typed by the user immediately preceding the carriage 
return w, rep oce the contents of the open register, if any register was open, and L registef wiU be ' 
closed. If nothing has been typed by the user, the contents will not be changed. 



Example: 

1/ Q027 p 

1/ 0027 14 j 

^ 



Register 0001 is unchanged 
Register 0001 will contain 001 4 
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6. 1 . 1 . 3 Line-Feed ( | ) 

The line-feed has the same effect as the carriage-return, but, in addition, the next sequential 
register is opened and its contents typed . 

Example: 

1/ 0027 i 

0002/ 0077 Register 0002 is opened; C(OOOl) is unchanged. 

1/ 0027 14| 

0002/ 0077 Register 0002 is opened; C(OOOl) is 0014. 

6.1 .1 .4 Any I i legal Character 

Any character that is neither an octal digit nor a valid control character causes the current 
line to be ignored . 



Example: 

19 ? 

6. 1 . 1 .5 Single Quote (') 

location specified before the ('). All indicators and registers will be restored and 
the break-trap, if any, will be inserted. Typing (') alone is an error. 

6. 1 . 1 .6 Double Quote (") 

Conditions ODT-II to insert a break-trap at the location specified before the ("). If no such 
ocation was specified, ODT-II removes the previous breakpoint. A breakpoint is actually inserted only 
when a goto ( ) or proceed ('.) is executed. ODT-II will remove the instruction at the break location and 
will save It for future restoration. The instruction at the break location is only executed after the proceed 

I s n I vpn " 



6. 1 . 1 .7 Exclamation ( I) 



Proceed from a break-trap. The C(AC) and C(L) are restored, 
ecu ted , and control transfers to the user's program 



the trapped instruction is ex 



NOTE; If a trap set by ODT is not encountered by the ob|ect (user's) program 
the breakpoi nt i nstruction will not be removed . 



• r r- 7000), however, will restore the original 

instruction. The breakpoint will be reinserted when goto (') or proceed (.') is executed. When a break- 

trap IS encountered in the user's program, ODT-II will type out the location of the trap, a right paren- 
thesis, and the contents of the accumulator. The accumulator and link are saved in registers 7350 and 
^ 351, respectively, (1350 and 1351 for low version). These registers may be examined (and modified) 
m the normal manner by use of the slash (/) control character. ^ 




6 . 1.1 .8 



M 
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Typing the letter M causes the contents of the mask register (see 6 . 1 . 1 . 1 1 ) to be printed and 
opened for modification . Initial ly, this value is set to 7777, 

6.1 .1 .9 < (Left Angle Bracket) 

Typing this character causes the contents of the lower search limit register (see 6.1.1.11) to 
be printed and opened for examination, initially, this value is set to 0001 . 

6.1 .1 .10 > (Right Angle Bracket) 

Typing this character causes the contents of the upper search limit register (see 6 . 1 . 1 . 1 1 ) to 
be printed and opened for examination. Initially, this value is set to 6777. 



NOTE: The registers named M, <, and > are within ODT-II and have addresses 
7550, 7551, and 7552, respectively. 



6.1 .1 .11 Word Searches 

Word searching using ODT-II is similar to word searching using DDT (see Digital-8-4-S) . The 
searching operations are used to determine If a given quantity is present In any of the registers of a par- 
ticular section of memory. The search is Initiated by the command: 

KW 



Where K is an octal expression. ODT-II will perform a word search and print the address 
and contents of every register in the desired section of memory whose contents, when masked by C(M) are 
equal to the value of the expression K. The search continues between the limits specified by C(<) and 



Example: Search locations 2000 to 4000 for 


M 7777 


7000 


Set the mask 


< 0001 


2000 


Set the lower limit 


> 6777 


4000 


Set the upper limit 


2000 W 




Initiate the search 


AlUZ, 1 / AAr(j7 







etc . 

6.1 .1 .12 Punch Commands 



LU 

Q 




< 
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Where K is the Initial address (octal) and 1 Is the final address (octal) of the register to be 
punched . The computer will halt, al lowing the operator to turn the Teletype off I i ne and to punch leader 
codes. Putting the Teletype back on line and depressing CONTI NUE initiates the actual punching of the 
block . The punching terminates without punching a checksum to a I low subsequent blocks to be punched 
and an all inclusive checksum to be punched at the end . This procedure is optional , however, and the 
user may punch individual ly checksummed blocks . See 6.1.1,13 for a descri ption of the checksum com- 
mand . If subsequent blocks are desired, turn off the punch before typing the pertinent commands . 

6.1 .1 .13 * (Checksum Command) 



Typing an asterisk (which does not print) causes the program to punch out the accumu lated 
checksum . The program wi 1 1 then halt to al low the operator to turn the Teletype off 1 ine, produce trailer 
code (200), and remove the tape , The operator shou Id then turn the punch off, turn the Teletype on line 
and depress CONTI NUE to resume ODT-I I operation . 



6 . 1.2 



Command Summary 




Slash (/) 


Register examination 


Carriage Return 


Register Is closed 


Line-Feed 


Closes register and opens the next one 


1 1 legal Character 


Current line is ignored . ODT-I 1 types ? 


Single Quote (') 


Goto 


Double Quote (") 


Set a break-trap. 


Exclamation (1) 


Proceed from trap. 


M 


Examine (and modify) mask 


< 


Examine (and modify) lower search limit 


> 


Examine (and modify) upper search limit 


W 


Word search command 


Semicolon (;) 


Separate punch arguments 


Alt Mode 


Punch in binary 


Asterisk (*) 


Punch checksum 



6.2 

6 . 2.1 



Examples and/or Applications 



Symbols for representing "invisible" Teletype actions: 



(CR) 

(LF) 

(ALT) 

(*) 

(H) 

(C) 

(PON) 

(POF) 

(TON) 

(TOF) 

(LEAD) 

(TEXT) 

(CKSM) 



= Carriage Return 
= Line Feed 
= Alt Mode 
= Nonprinting Asterisk 
= Halt 
= Continue 
= Punch On 
= Punch Off 
= Teletype On 
= Teletype Off 
= Production of Leader 
= Punching of Text 
= Punching of Checksum 
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6.2.2 Underlined functions and expressions are those produced by ODT-li. 

6.2.3 Brackets enclose comments local to this description . 



6.2.4 Examples of Register Examination and 

100/ 1234 7777 (CR) (m 
100/ 7777 (CR) (LF) 

(LF) {CFT 

010i/T564 (LF) (CR) 

0102/ 4567 2222X? (CR) (LF) 

102/ 45 6 7 22222? (CR)(LF) 

102/ 4567 2222 (CR) (LF) 

102/ 2^ (CR) (LF) 

6.2.5 Word Searching Example 

M 7777 (CR) (LF) 

< 0001 (CR) (iFy 

> 6777 (CR) (Uy 
7200W (CR) (LTT 
0150/7200 (CR) (LF) 

1216/7200 (CR) (LF) 

M 7777 600 (CR) (LF) 

< 0001 200 (CR) (LF/ 

400W (CR) (LF) 

1426/3403 (CR) (LF) 

1627’/5400 (CR) (LF) 

1705/7402 (CR) (LF) 

itf) 

M 0600 7777 (CR) (LF) 

< 6777 (CR) {Wy 

6.2.6 Octal Dump Example 

[ V/e wish to dump core between 1000 
M 7777 0 (CR) (LF) 

0001 1000 (Cl T(LF) 

6777 1005 (CR) (Ir j 

W (W(LF) 

100S70OT“ (CR) (LF) 

1001/0002 (CR) (LF) 

1002/0003 (CR) (LF) 

1003/0004 (CR) (LF) 

T004/0005 (CR) (LF) 

1006/0006 (CR) (LF) 

M 0000 7777 (CR) (LF) 

< 1000 0001 (CR) (TFT 

> 1005 6777 (CR) (TfT 



Modification 

[Examine and modify.] 

[ Examine only . | 

[ Examine next . ] 

[ Examine next. ] 

[ i I legal character, ] 

1 More than four integers typed , ] 

1 Correct modification . ] 

1 Success at last I ] 

[Examination of parameters.] 

[Search for all CLA instructions .] 

[Set mask for indirect and page bits.] 

[Set limits to exclude page 0.] 

[Search for all Indirect references to page 0 from 
other pages . ] 

[ HLT looks like an indirect ref. to page 0. ] 
[Searching completed .] 

[ Reset mask] 

[ and lower limit. ] 

- ’005] 

[ Set mask to 0 . ] 

[ Set I imi ts to encompass dump area . ] 

[ Since W is typed alone, the word searched for Is 0 
The result after masking each register with 0 is, of 
course, 0 so all comparisons appear to the program 
equal and hence all unmasked contents are typed, 
constituting a dump . ] 



[ Reset parameters. ] 
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6.2.7 Example of Paper Tape Punchout (Binary Format-) . 

[ The punchout of page 1 and the first 5 O 3 registers of page 3.] 

[ The TTY is assumed to be on line and the punch turned off. ] 

200;377(ALT) {_H) (TOF) (PON) (LEAD) (TON) (C) (TEXT) (POF) (CR) (LF) 

600;647(ALT) (_H) (PON) (C) (TEXT) (*) (CKSM) (H ) (TOF) (LEAD) (POTT(TON) (C) (CR) (LF) 
[ ODT-1 1 now running in input mode waiting further commands . 1 



[ Remove tape from punch . ] 

6.2.8 Examples of Using Break-Trap Mode 

241" (CR) (LF) 

241/7200 (CR) (LF) 

200' (CR) (LF) 

0241 )0324 (CR) (LF) 

7351/0001 (CR) (LF) 

241/7200 (CR) (_LFr 



253" (CR) (LF) 

‘ (CR) (LF) 

0253)0000 (CR) (jJF) 

" (CR) (LF) 

■ (CRj (LF) 

[To reenter ODT-II, user would have 

7. METHODS (Not Applicable) 

8 . FORMAT (Not Applicable) 

9. EXECUTION TIME (Not Applicable) 



[Set break to occur at user's loc. 241 .] 

[ Examination shows that trap inst . not yet inserted . ] 
[Enter user's program at location 200.] 

[ Break-trap occurs, and C(AC) typed.] 

[ Examination of state of link at break . ] 

[Any amount of DDT functions may be indulged] 

[in at this point before continuing.] 

[Break-trap reset at loc. 253.] 

[User's program continued from point of last break (241 ). ] 
[Second break occurs.] 

[ Break-trap mode deactivated.] 

[User's program continued without any traps set.] 

to start at 7000. ] 



10 . 



PROGRAM 




